home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 23 / AACD 23.iso / AACD / Magazine / PC2Amiga / Samba / docs / faq / sambafaq.txt < prev    next >
Text File  |  2000-04-25  |  42KB  |  1,123 lines
  1.   Samba FAQ
  2.   Paul Blackman, ictinus@samba.org
  3.   v 0.8, June '97
  4.  
  5.   This is the Frequently Asked Questions (FAQ) document for Samba, the
  6.   free and very popular SMB server product. An SMB server allows file
  7.   and printer connections from clients such as Windows, OS/2, Linux and
  8.   others. Current to version 1.9.17. Please send any corrections to the
  9.   author.
  10.   ______________________________________________________________________
  11.  
  12.   Table of Contents:
  13.  
  14.   1.      General Information
  15.  
  16.   1.1.    What is Samba?
  17.  
  18.   1.2.    What is the current version of Samba?
  19.  
  20.   1.3.    Where can I get it?
  21.  
  22.   1.4.    What do the version numbers mean?
  23.  
  24.   1.5.    What platforms are supported?
  25.  
  26.   1.6.    How can I find out more about Samba?
  27.  
  28.   1.7.    How do I subscribe to the Samba Mailing Lists?
  29.  
  30.   1.8.    Something's gone wrong - what should I do?
  31.  
  32.   1.9.    Pizza supply details
  33.  
  34.   2.      Compiling and installing Samba on a Unix host
  35.  
  36.   2.1.    I can't see the Samba server in any browse lists!
  37.  
  38.   2.2.    Some files that I KNOW are on the server doesn't show up when
  39.   I view the files from my client!
  40.  
  41.   2.3.    Some files on the server show up with really wierd filenames
  42.   when I view the files from my client!
  43.  
  44.   2.4.    My client reports "cannot locate specified computer" or
  45.   similar
  46.  
  47.   2.5.    My client reports "cannot locate specified share name" or
  48.   similar
  49.  
  50.   2.6.    My client reports "cannot find domain controller", "cannot log
  51.   on to the network" or similar
  52.  
  53.   2.7.    Printing doesn't work :-(
  54.  
  55.   2.8.    My programs install on the server OK, but refuse to work
  56.   properly
  57.  
  58.   2.9.    My "server string" doesn't seem to be recognised
  59.  
  60.   2.10.   My client reports "This server is not configured to list
  61.   shared resources"
  62.  
  63.   2.11.   Log message "you appear to have a trapdoor uid system"
  64.  
  65.   3.      Common client questions
  66.  
  67.   3.1.    Are there any Macintosh clients for Samba?
  68.  
  69.   3.2.    "Session request failed (131,130)" error
  70.  
  71.   3.3.    How do I synchronise my PC's clock with my Samba server?
  72.  
  73.   3.4.    Problems with WinDD, NTrigue, WinCenterPro etc
  74.  
  75.   3.5.    Problem with printers under NT
  76.  
  77.   3.6.    Why are my file's timestamps off by an hour, or by a few
  78.   hours?
  79.  
  80.   3.7.    How do I set the printer driver name correctly?
  81.  
  82.   3.8.    I've applied NT 4.0 SP3, and now I can't access Samba shares,
  83.   Why?
  84.  
  85.   4.      Specific client application problems
  86.  
  87.   4.1.    MS Office Setup reports "Cannot change properties of
  88.   'MSOFFICEUP.INI'"
  89.  
  90.   5.      Miscellaneous
  91.  
  92.   5.1.    Is Samba Year 2000 compliant?
  93.   ______________________________________________________________________
  94.  
  95.   11..  GGeenneerraall IInnffoorrmmaattiioonn
  96.  
  97.  
  98.  
  99.   All about Samba - what it is, how to get it, related sources of
  100.   information, how to understand the version numbering scheme, pizza
  101.   details
  102.  
  103.  
  104.   11..11..  WWhhaatt iiss SSaammbbaa??
  105.  
  106.  
  107.   Samba is a suite of programs which work together to allow clients to
  108.   access to a server's filespace and printers via the SMB (Server
  109.   Message Block) protocol. Initially written for Unix, Samba now also
  110.   runs on Netware, OS/2 and VMS.
  111.  
  112.   In practice, this means that you can redirect disks and printers to
  113.   Unix disks and printers from Lan Manager clients, Windows for
  114.   Workgroups 3.11 clients, Windows NT clients, Linux clients and OS/2
  115.   clients. There is also a generic Unix client program supplied as part
  116.   of the suite which allows Unix users to use an ftp-like interface to
  117.   access filespace and printers on any other SMB servers. This gives the
  118.   capability for these operating systems to behave much like a LAN
  119.   Server or Windows NT Server machine, only with added functionality and
  120.   flexibility designed to make life easier for administrators.
  121.  
  122.   The components of the suite are (in summary):
  123.  
  124.  
  125.   +o  ssmmbbdd, the SMB server. This handles actual connections from clients,
  126.      doing all the file, permission and username work
  127.  
  128.   +o  nnmmbbdd, the Netbios name server, which helps clients locate servers,
  129.      doing the browsing work and managing domains as this capability is
  130.      being built into Samba
  131.  
  132.  
  133.   +o  ssmmbbcclliieenntt, the Unix-hosted client program
  134.  
  135.   +o  ssmmbbrruunn, a little 'glue' program to help the server run external
  136.      programs
  137.  
  138.   +o  tteessttpprrnnss, a program to test server access to printers
  139.  
  140.   +o  tteessttppaarrmmss, a program to test the Samba configuration file for
  141.      correctness
  142.  
  143.   +o  ssmmbb..ccoonnff, the Samba configuration file
  144.  
  145.   +o  ssmmbbpprriinntt, a sample script to allow a Unix host to use smbclient to
  146.      print to an SMB server
  147.  
  148.   +o  DDooccuummeennttaattiioonn!! DON'T neglect to read it - you will save a great
  149.      deal of time!
  150.  
  151.   The suite is supplied with full source (of course!) and is GPLed.
  152.  
  153.   The primary creator of the Samba suite is Andrew Tridgell. Later
  154.   versions incorporate much effort by many net.helpers. The man pages
  155.   and this FAQ were originally written by Karl Auer.
  156.  
  157.  
  158.   11..22..  WWhhaatt iiss tthhee ccuurrrreenntt vveerrssiioonn ooff SSaammbbaa??
  159.  
  160.  
  161.   At time of writing, the current version was 1.9.17. If you want to be
  162.   sure check the bottom of the change-log file.
  163.   <ftp://samba.org/pub/samba/alpha/change-log>
  164.  
  165.   For more information see ``What do the version numbers mean?''
  166.  
  167.  
  168.   11..33..  WWhheerree ccaann II ggeett iitt??
  169.  
  170.  
  171.   The Samba suite is available via anonymous ftp from samba.org.
  172.   The latest and greatest versions of the suite are in the directory:
  173.  
  174.   /pub/samba/
  175.  
  176.   Development (read "alpha") versions, which are NOT necessarily stable
  177.   and which do NOT necessarily have accurate documentation, are
  178.   available in the directory:
  179.  
  180.   /pub/samba/alpha
  181.  
  182.   Note that binaries are NOT included in any of the above. Samba is
  183.   distributed ONLY in source form, though binaries may be available from
  184.   other sites. Recent versions of some Linux distributions, for example,
  185.   do contain Samba binaries for that platform.
  186.  
  187.  
  188.   11..44..  WWhhaatt ddoo tthhee vveerrssiioonn nnuummbbeerrss mmeeaann??
  189.  
  190.  
  191.   It is not recommended that you run a version of Samba with the word
  192.   "alpha" in its name unless you know what you are doing and are willing
  193.   to do some debugging. Many, many people just get the latest
  194.   recommended stable release version and are happy. If you are brave, by
  195.   all means take the plunge and help with the testing and development -
  196.   but don't install it on your departmental server. Samba is typically
  197.   very stable and safe, and this is mostly due to the policy of many
  198.   public releases.
  199.   How the scheme works:
  200.  
  201.   1. When major changes are made the version number is increased. For
  202.      example, the transition from 1.9.15 to 1.9.16. However, this
  203.      version number will not appear immediately and people should
  204.      continue to use 1.9.15 for production systems (see next point.)
  205.  
  206.   2. Just after major changes are made the software is considered
  207.      unstable, and a series of alpha releases are distributed, for
  208.      example 1.9.16alpha1. These are for testing by those who know what
  209.      they are doing.  The "alpha" in the filename will hopefully scare
  210.      off those who are just looking for the latest version to install.
  211.  
  212.   3. When Andrew thinks that the alphas have stabilised to the point
  213.      where he would recommend new users install it, he renames it to the
  214.      same version number without the alpha, for example 1.9.16.
  215.  
  216.   4. Inevitably bugs are found in the "stable" releases and minor patch
  217.      levels are released which give us the pXX series, for example
  218.      1.9.16p2.
  219.  
  220.      So the progression goes:
  221.  
  222.                      1.9.15p7        (production)
  223.                      1.9.15p8        (production)
  224.                      1.9.16alpha1    (test sites only)
  225.                        :
  226.                      1.9.16alpha20   (test sites only)
  227.                      1.9.16          (production)
  228.                      1.9.16p1        (production)
  229.  
  230.  
  231.   The above system means that whenever someone looks at the samba ftp
  232.   site they will be able to grab the highest numbered release without an
  233.   alpha in the name and be sure of getting the current recommended ver-
  234.   sion.
  235.  
  236.  
  237.   11..55..  WWhhaatt ppllaattffoorrmmss aarree ssuuppppoorrtteedd??
  238.  
  239.  
  240.   Many different platforms have run Samba successfully. The platforms
  241.   most widely used and thus best tested are Linux and SunOS.
  242.  
  243.   At time of writing, the Makefile claimed support for:
  244.  
  245.   +o  A/UX 3.0
  246.  
  247.   +o  AIX
  248.  
  249.   +o  Altos Series 386/1000
  250.  
  251.   +o  Amiga
  252.  
  253.   +o  Apollo Domain/OS sr10.3
  254.  
  255.   +o  BSDI
  256.  
  257.   +o  B.O.S. (Bull Operating System)
  258.  
  259.   +o  Cray, Unicos 8.0
  260.  
  261.   +o  Convex
  262.  
  263.   +o  DGUX.
  264.  
  265.   +o  DNIX.
  266.  
  267.   +o  FreeBSD
  268.  
  269.   +o  HP-UX
  270.  
  271.   +o  Intergraph.
  272.  
  273.   +o  Linux with/without shadow passwords and quota
  274.  
  275.   +o  LYNX 2.3.0
  276.  
  277.   +o  MachTen (a unix like system for Macintoshes)
  278.  
  279.   +o  Motorola 88xxx/9xx range of machines
  280.  
  281.   +o  NetBSD
  282.  
  283.   +o  NEXTSTEP Release 2.X, 3.0 and greater (including OPENSTEP for
  284.      Mach).
  285.  
  286.   +o  OS/2 using EMX 0.9b
  287.  
  288.   +o  OSF1
  289.  
  290.   +o  QNX 4.22
  291.  
  292.   +o  RiscIX.
  293.  
  294.   +o  RISCOs 5.0B
  295.  
  296.   +o  SEQUENT.
  297.  
  298.   +o  SCO (including: 3.2v2, European dist., OpenServer 5)
  299.  
  300.   +o  SGI.
  301.  
  302.   +o  SMP_DC.OSx v1.1-94c079 on Pyramid S series
  303.  
  304.   +o  SONY NEWS, NEWS-OS (4.2.x and 6.1.x)
  305.  
  306.   +o  SUNOS 4
  307.  
  308.   +o  SUNOS 5.2, 5.3, and 5.4 (Solaris 2.2, 2.3, and '2.4 and later')
  309.  
  310.   +o  Sunsoft ISC SVR3V4
  311.  
  312.   +o  SVR4
  313.  
  314.   +o  System V with some berkely extensions (Motorola 88k R32V3.2).
  315.  
  316.   +o  ULTRIX.
  317.  
  318.   +o  UNIXWARE
  319.  
  320.   +o  UXP/DS
  321.  
  322.  
  323.   11..66..  HHooww ccaann II ffiinndd oouutt mmoorree aabboouutt SSaammbbaa??
  324.  
  325.  
  326.   There are a number of places to look for more information on Samba,
  327.   including:
  328.  
  329.   +o  Two mailing lists devoted to discussion of Samba-related matters.
  330.  
  331.   +o  The newsgroup, comp.protocols.smb, which has a great deal of
  332.      discussion on Samba.
  333.  
  334.   +o  The WWW site 'SAMBA Web Pages' at  <http://samba.edu.au/samba/>
  335.      includes:
  336.  
  337.   +o  Links to man pages and documentation, including this FAQ
  338.  
  339.   +o  A comprehensive survey of Samba users.
  340.  
  341.   +o  A searchable hypertext archive of the Samba mailing list.
  342.  
  343.   +o  Links to Samba source code, binaries, and mirrors of both.
  344.  
  345.   +o  The long list of topic documentation.  These files can be found in
  346.      the 'docs' directory of the Samba source, or at
  347.      <ftp://samba.org/pub/samba/docs/>
  348.  
  349.   +o  Application_Serving.txt
  350.      <ftp://samba.org/pub/samba/docs/Application_Serving.txt>
  351.  
  352.   +o  BROWSING.txt <ftp://samba.org/pub/samba/docs/BROWSING.txt>
  353.  
  354.   +o  BUGS.txt <ftp://samba.org/pub/samba/docs/BUGS.txt>
  355.  
  356.   +o  DIAGNOSIS.txt <ftp://samba.org/pub/samba/docs/DIAGNOSIS.txt>
  357.  
  358.   +o  DNIX.txt <ftp://samba.org/pub/samba/docs/DNIX.txt>
  359.  
  360.   +o  DOMAIN.txt <ftp://samba.org/pub/samba/docs/DOMAIN.txt>
  361.  
  362.   +o  CONTROL.txt
  363.      <ftp://samba.org/pub/samba/docs/DOMAIN_CONTROL.txt>
  364.  
  365.   +o  ENCRYPTION.txt
  366.      <ftp://samba.org/pub/samba/docs/ENCRYPTION.txt>
  367.  
  368.   +o  Faxing.txt <ftp://samba.org/pub/samba/docs/Faxing.txt>
  369.  
  370.   +o  GOTCHAS.txt <ftp://samba.org/pub/samba/docs/GOTCHAS.txt>
  371.  
  372.   +o  HINTS.txt <ftp://samba.org/pub/samba/docs/HINTS.txt>
  373.  
  374.   +o  INSTALL.sambatar
  375.      <ftp://samba.org/pub/samba/docs/INSTALL.sambatar>
  376.  
  377.   +o  INSTALL.txt <ftp://samba.org/pub/samba/docs/INSTALL.txt>
  378.  
  379.   +o  MIRRORS <ftp://samba.org/pub/samba/docs/MIRRORS>
  380.  
  381.   +o  NetBIOS.txt <ftp://samba.org/pub/samba/docs/NetBIOS.txt>
  382.  
  383.   +o  OS2.txt <ftp://samba.org/pub/samba/docs/OS2.txt>
  384.  
  385.   +o  PROJECTS <ftp://samba.org/pub/samba/docs/PROJECTS>
  386.  
  387.   +o  Passwords.txt <ftp://samba.org/pub/samba/docs/Passwords.txt>
  388.  
  389.   +o  Printing.txt <ftp://samba.org/pub/samba/docs/Printing.txt>
  390.  
  391.   +o  README.DCEDFS <ftp://samba.org/pub/samba/docs/README.DCEDFS>
  392.  
  393.   +o  README.OS2 <ftp://samba.org/pub/samba/docs/README.OS2>
  394.  
  395.   +o  README.jis <ftp://samba.org/pub/samba/docs/README.jis>
  396.  
  397.   +o  README.sambatar
  398.      <ftp://samba.org/pub/samba/docs/README.sambatar>
  399.  
  400.   +o  SCO.txt <ftp://samba.org/pub/samba/docs/SCO.txt>
  401.  
  402.   +o  SMBTAR.notes <ftp://samba.org/pub/samba/docs/SMBTAR.notes>
  403.  
  404.   +o  Speed.txt <ftp://samba.org/pub/samba/docs/Speed.txt>
  405.  
  406.   +o  Support.txt <ftp://samba.org/pub/samba/docs/Support.txt>
  407.  
  408.   +o  THANKS <ftp://samba.org/pub/samba/docs/THANKS>
  409.  
  410.   +o  Tracing.txt <ftp://samba.org/pub/samba/docs/Tracing.txt>
  411.  
  412.   +o  SMB.txt <ftp://samba.org/pub/samba/docs/UNIX-SMB.txt>
  413.  
  414.   +o  Warp.txt <ftp://samba.org/pub/samba/docs/Warp.txt>
  415.  
  416.   +o  WinNT.txt <ftp://samba.org/pub/samba/docs/WinNT.txt>
  417.  
  418.   +o  history <ftp://samba.org/pub/samba/docs/history>
  419.  
  420.   +o  level.txt
  421.      <ftp://samba.org/pub/samba/docs/security_level.txt>
  422.  
  423.   +o  slip.htm <ftp://samba.org/pub/samba/docs/wfw_slip.htm>
  424.  
  425.  
  426.   11..77..  HHooww ddoo II ssuubbssccrriibbee ttoo tthhee SSaammbbaa MMaaiilliinngg LLiissttss??
  427.  
  428.  
  429.   Send email to listproc@samba.org. Make sure the subject line is
  430.   blank, and include the following two lines in the body of the message:
  431.  
  432.  
  433.        subscribe samba Firstname Lastname
  434.        subscribe samba-announce Firstname Lastname
  435.  
  436.  
  437.  
  438.  
  439.   Obviously you should substitute YOUR first name for "Firstname" and
  440.   YOUR last name for "Lastname"! Try not to send any signature stuff, it
  441.   sometimes confuses the list processor.
  442.  
  443.   The samba list is a digest list - every eight hours or so it
  444.   regurgitates a single message containing all the messages that have
  445.   been received by the list since the last time and sends a copy of this
  446.   message to all subscribers.
  447.  
  448.   If you stop being interested in Samba, please send another email to
  449.   listproc@samba.org. Make sure the subject line is blank, and
  450.   include the following two lines in the body of the message:
  451.  
  452.  
  453.        unsubscribe samba
  454.        unsubscribe samba-announce
  455.  
  456.  
  457.  
  458.  
  459.   The FFrroomm:: line in your message _M_U_S_T be the same address you used when
  460.   you subscribed.
  461.  
  462.  
  463.   11..88..  SSoommeetthhiinngg''ss ggoonnee wwrroonngg -- wwhhaatt sshhoouulldd II ddoo??
  464.  
  465.  
  466.   ## ****** IIMMPPOORRTTAANNTT!! ****** ##
  467.  
  468.   DO NOT post messages on mailing lists or in newsgroups until you have
  469.   carried out the first three steps given here!
  470.  
  471.   Firstly, see if there are any likely looking entries in this FAQ! If
  472.   you have just installed Samba, have you run through the checklist in
  473.   DIAGNOSIS.txt <ftp://samba.org/pub/samba/DIAGNOSIS.txt>? It can
  474.   save you a lot of time and effort.  DIAGNOSIS.txt can also be found in
  475.   the docs directory of the Samba distribution.
  476.  
  477.   Secondly, read the man pages for smbd, nmbd and smb.conf, looking for
  478.   topics that relate to what you are trying to do.
  479.  
  480.   Thirdly, if there is no obvious solution to hand, try to get a look at
  481.   the log files for smbd and/or nmbd for the period during which you
  482.   were having problems. You may need to reconfigure the servers to
  483.   provide more extensive debugging information - usually level 2 or
  484.   level 3 provide ample debugging info. Inspect these logs closely,
  485.   looking particularly for the string "Error:".
  486.  
  487.   Fourthly, if you still haven't got anywhere, ask the mailing list or
  488.   newsgroup.  In general nobody minds answering questions provided you
  489.   have followed the preceding steps. It might be a good idea to scan the
  490.   archives of the mailing list, which are available through the Samba
  491.   web site described in the previous section.
  492.  
  493.   If you successfully solve a problem, please mail the FAQ maintainer a
  494.   succinct description of the symptom, the problem and the solution, so
  495.   I can incorporate it in the next version.
  496.  
  497.   If you make changes to the source code, _please_ submit these patches
  498.   so that everyone else gets the benefit of your work. This is one of
  499.   the most important aspects to the maintainence of Samba. Send all
  500.   patches to samba@samba.org. Do not send patches to Andrew
  501.   Tridgell or any other individual, they may be lost if you do.
  502.  
  503.  
  504.   11..99..  PPiizzzzaa ssuuppppllyy ddeettaaiillss
  505.  
  506.  
  507.   Those who have registered in the Samba survey as "Pizza Factory" will
  508.   already know this, but the rest may need some help. Andrew doesn't ask
  509.   for payment, but he does appreciate it when people give him pizza.
  510.   This calls for a little organisation when the pizza donor is twenty
  511.   thousand kilometres away, but it has been done.
  512.  
  513.   Method 1: Ring up your local branch of an international pizza chain
  514.   and see if they honour their vouchers internationally. Pizza Hut do,
  515.   which is how the entire Canberra Linux Users Group got to eat pizza
  516.   one night, courtesy of someone in the US
  517.  
  518.   Method 2: Ring up a local pizza shop in Canberra and quote a credit
  519.   card number for a certain amount, and tell them that Andrew will be
  520.   collecting it (don't forget to tell him.) One kind soul from Germany
  521.   did this.
  522.  
  523.   Method 3: Purchase a pizza voucher from your local pizza shop that has
  524.   no international affiliations and send it to Andrew. It is completely
  525.   useless but he can hang it on the wall next to the one he already has
  526.   from Germany :-)
  527.  
  528.  
  529.   Method 4: Air freight him a pizza with your favourite regional
  530.   flavours. It will probably get stuck in customs or torn apart by
  531.   hungry sniffer dogs but it will have been a noble gesture.
  532.  
  533.  
  534.   22..  CCoommppiilliinngg aanndd iinnssttaalllliinngg SSaammbbaa oonn aa UUnniixx hhoosstt
  535.  
  536.  
  537.  
  538.   22..11..  II ccaann''tt sseeee tthhee SSaammbbaa sseerrvveerr iinn aannyy bbrroowwssee lliissttss!!
  539.  
  540.  
  541.   See BROWSING.txt <ftp://samba.org/pub/samba/BROWSING.txt> for
  542.   more information on browsing.  Browsing.txt can also be found in the
  543.   docs directory of the Samba source.
  544.  
  545.   If your GUI client does not permit you to select non-browsable
  546.   servers, you may need to do so on the command line. For example, under
  547.   Lan Manager you might connect to the above service as disk drive M:
  548.   thusly:
  549.  
  550.  
  551.           net use M: \\mary\fred
  552.  
  553.  
  554.  
  555.  
  556.   The details of how to do this and the specific syntax varies from
  557.   client to client - check your client's documentation.
  558.  
  559.  
  560.   22..22..  SSoommee ffiilleess tthhaatt II KKNNOOWW aarree oonn tthhee sseerrvveerr ddooeessnn''tt sshhooww uupp wwhheenn II
  561.   vviieeww tthhee ffiilleess ffrroomm mmyy cclliieenntt!!
  562.  
  563.  
  564.   See the next question.
  565.  
  566.   22..33..  SSoommee ffiilleess oonn tthhee sseerrvveerr sshhooww uupp wwiitthh rreeaallllyy wwiieerrdd ffiilleennaammeess
  567.   wwhheenn II vviieeww tthhee ffiilleess ffrroomm mmyy cclliieenntt!!
  568.  
  569.  
  570.   If you check what files are not showing up, you will note that they
  571.   are files which contain upper case letters or which are otherwise not
  572.   DOS-compatible (ie, they are not legal DOS filenames for some reason).
  573.  
  574.   The Samba server can be configured either to ignore such files
  575.   completely, or to present them to the client in "mangled" form. If you
  576.   are not seeing the files at all, the Samba server has most likely been
  577.   configured to ignore them.  Consult the man page smb.conf(5) for
  578.   details of how to change this - the parameter you need to set is
  579.   "mangled names = yes".
  580.  
  581.  
  582.   22..44..  MMyy cclliieenntt rreeppoorrttss ""ccaannnnoott llooccaattee ssppeecciiffiieedd ccoommppuutteerr"" oorr ssiimmiillaarr
  583.  
  584.  
  585.   This indicates one of three things: You supplied an incorrect server
  586.   name, the underlying TCP/IP layer is not working correctly, or the
  587.   name you specified cannot be resolved.
  588.  
  589.   After carefully checking that the name you typed is the name you
  590.   should have typed, try doing things like pinging a host or telnetting
  591.   to somewhere on your network to see if TCP/IP is functioning OK. If it
  592.   is, the problem is most likely name resolution.
  593.  
  594.  
  595.   If your client has a facility to do so, hardcode a mapping between the
  596.   hosts IP and the name you want to use. For example, with Man Manager
  597.   or Windows for Workgroups you would put a suitable entry in the file
  598.   LMHOSTS. If this works, the problem is in the communication between
  599.   your client and the netbios name server. If it does not work, then
  600.   there is something fundamental wrong with your naming and the solution
  601.   is beyond the scope of this document.
  602.  
  603.   If you do not have any server on your subnet supplying netbios name
  604.   resolution, hardcoded mappings are your only option. If you DO have a
  605.   netbios name server running (such as the Samba suite's nmbd program),
  606.   the problem probably lies in the way it is set up. Refer to Section
  607.   Two of this FAQ for more ideas.
  608.  
  609.   By the way, remember to REMOVE the hardcoded mapping before further
  610.   tests :-)
  611.  
  612.  
  613.   22..55..  MMyy cclliieenntt rreeppoorrttss ""ccaannnnoott llooccaattee ssppeecciiffiieedd sshhaarree nnaammee"" oorr ssiimmii--
  614.   llaarr
  615.  
  616.  
  617.   This message indicates that your client CAN locate the specified
  618.   server, which is a good start, but that it cannot find a service of
  619.   the name you gave.
  620.  
  621.   The first step is to check the exact name of the service you are
  622.   trying to connect to (consult your system administrator). Assuming it
  623.   exists and you specified it correctly (read your client's doco on how
  624.   to specify a service name correctly), read on:
  625.  
  626.  
  627.   +o  Many clients cannot accept or use service names longer than eight
  628.      characters.
  629.  
  630.   +o  Many clients cannot accept or use service names containing spaces.
  631.  
  632.   +o  Some servers (not Samba though) are case sensitive with service
  633.      names.
  634.  
  635.   +o  Some clients force service names into upper case.
  636.  
  637.  
  638.   22..66..  MMyy cclliieenntt rreeppoorrttss ""ccaannnnoott ffiinndd ddoommaaiinn ccoonnttrroolllleerr"",, ""ccaannnnoott lloogg
  639.   oonn ttoo tthhee nneettwwoorrkk"" oorr ssiimmiillaarr
  640.  
  641.  
  642.   Nothing is wrong - Samba does not implement the primary domain name
  643.   controller stuff for several reasons, including the fact that the
  644.   whole concept of a primary domain controller and "logging in to a
  645.   network" doesn't fit well with clients possibly running on multiuser
  646.   machines (such as users of smbclient under Unix). Having said that,
  647.   several developers are working hard on building it in to the next
  648.   major version of Samba. If you can contribute, send a message to
  649.   samba@samba.org !
  650.  
  651.   Seeing this message should not affect your ability to mount redirected
  652.   disks and printers, which is really what all this is about.
  653.  
  654.   For many clients (including Windows for Workgroups and Lan Manager),
  655.   setting the domain to STANDALONE at least gets rid of the message.
  656.  
  657.  
  658.  
  659.  
  660.  
  661.   22..77..  PPrriinnttiinngg ddooeessnn''tt wwoorrkk ::--((
  662.  
  663.  
  664.   Make sure that the specified print command for the service you are
  665.   connecting to is correct and that it has a fully-qualified path (eg.,
  666.   use "/usr/bin/lpr" rather than just "lpr").
  667.  
  668.   Make sure that the spool directory specified for the service is
  669.   writable by the user connected to the service. In particular the user
  670.   "nobody" often has problems with printing, even if it worked with an
  671.   earlier version of Samba. Try creating another guest user other than
  672.   "nobody".
  673.  
  674.   Make sure that the user specified in the service is permitted to use
  675.   the printer.
  676.  
  677.   Check the debug log produced by smbd. Search for the printer name and
  678.   see if the log turns up any clues. Note that error messages to do with
  679.   a service ipc$ are meaningless - they relate to the way the client
  680.   attempts to retrieve status information when using the LANMAN1
  681.   protocol.
  682.  
  683.   If using WfWg then you need to set the default protocol to TCP/IP, not
  684.   Netbeui. This is a WfWg bug.
  685.  
  686.   If using the Lanman1 protocol (the default) then try switching to
  687.   coreplus.  Also not that print status error messages don't mean
  688.   printing won't work. The print status is received by a different
  689.   mechanism.
  690.  
  691.  
  692.   22..88..  MMyy pprrooggrraammss iinnssttaallll oonn tthhee sseerrvveerr OOKK,, bbuutt rreeffuussee ttoo wwoorrkk pprroopp--
  693.   eerrllyy
  694.  
  695.  
  696.   There are numerous possible reasons for this, but one MAJOR
  697.   possibility is that your software uses locking. Make sure you are
  698.   using Samba 1.6.11 or later. It may also be possible to work around
  699.   the problem by setting "locking=no" in the Samba configuration file
  700.   for the service the software is installed on. This should be regarded
  701.   as a strictly temporary solution.
  702.  
  703.   In earlier Samba versions there were some difficulties with the very
  704.   latest Microsoft products, particularly Excel 5 and Word for Windows
  705.   6. These should have all been solved. If not then please let Andrew
  706.   Tridgell know via email at samba@samba.org.
  707.  
  708.  
  709.   22..99..  MMyy ""sseerrvveerr ssttrriinngg"" ddooeessnn''tt sseeeemm ttoo bbee rreeccooggnniisseedd
  710.  
  711.  
  712.   OR My client reports the default setting, eg. "Samba 1.9.15p4",
  713.   instead of what I have changed it to in the smb.conf file.
  714.  
  715.   You need to use the -C option in nmbd. The "server string" affects
  716.   what smbd puts out and -C affects what nmbd puts out.
  717.  
  718.   Current versions of Samba (1.9.16 +) have combined these options into
  719.   the "server string" field of smb.conf, -C for nmbd is now obsolete.
  720.  
  721.  
  722.   22..1100..  MMyy cclliieenntt rreeppoorrttss ""TThhiiss sseerrvveerr iiss nnoott ccoonnffiigguurreedd ttoo lliisstt sshhaarreedd
  723.   rreessoouurrcceess""
  724.  
  725.  
  726.   Your guest account is probably invalid for some reason. Samba uses the
  727.   guest account for browsing in smbd.  Check that your guest account is
  728.   valid.
  729.  
  730.   See also 'guest account' in smb.conf man page.
  731.  
  732.  
  733.   22..1111..  LLoogg mmeessssaaggee ""yyoouu aappppeeaarr ttoo hhaavvee aa ttrraappddoooorr uuiidd ssyysstteemm""
  734.  
  735.  
  736.   This can have several causes. It might be because you are using a uid
  737.   or gid of 65535 or -1. This is a VERY bad idea, and is a big security
  738.   hole. Check carefully in your /etc/passwd file and make sure that no
  739.   user has uid 65535 or -1. Especially check the "nobody" user, as many
  740.   broken systems are shipped with nobody setup with a uid of 65535.
  741.  
  742.   It might also mean that your OS has a trapdoor uid/gid system :-)
  743.  
  744.   This means that once a process changes effective uid from root to
  745.   another user it can't go back to root. Unfortunately Samba relies on
  746.   being able to change effective uid from root to non-root and back
  747.   again to implement its security policy. If your OS has a trapdoor uid
  748.   system this won't work, and several things in Samba may break. Less
  749.   things will break if you use user or server level security instead of
  750.   the default share level security, but you may still strike problems.
  751.  
  752.   The problems don't give rise to any security holes, so don't panic,
  753.   but it does mean some of Samba's capabilities will be unavailable.  In
  754.   particular you will not be able to connect to the Samba server as two
  755.   different uids at once. This may happen if you try to print as a
  756.   "guest" while accessing a share as a normal user. It may also affect
  757.   your ability to list the available shares as this is normally done as
  758.   the guest user.
  759.  
  760.   Complain to your OS vendor and ask them to fix their system.
  761.  
  762.   Note: the reason why 65535 is a VERY bad choice of uid and gid is that
  763.   it casts to -1 as a uid, and the setreuid() system call ignores (with
  764.   no error) uid changes to -1. This means any daemon attempting to run
  765.   as uid 65535 will actually run as root. This is not good!
  766.  
  767.  
  768.   33..  CCoommmmoonn cclliieenntt qquueessttiioonnss
  769.  
  770.  
  771.  
  772.  
  773.   33..11..  AArree tthheerree aannyy MMaacciinnttoosshh cclliieennttss ffoorr SSaammbbaa??
  774.  
  775.  
  776.   Yes! Thursby now have a CIFS Client / Server called DAVE - see
  777.   <http://www.thursby.com/>.  They test it against Windows 95, Windows
  778.   NT and samba for compatibility issues.  At the time of writing, DAVE
  779.   was at version 1.0.1. The 1.0.0 to 1.0.1 update is available as a free
  780.   download from the Thursby web site (the speed of finder copies has
  781.   been greatly enhanced, and there are bug-fixes included).
  782.  
  783.   Alternatives - There are two free implementations of AppleTalk for
  784.   several kinds of UNIX machnes, and several more commercial ones.
  785.   These products allow you to run file services and print services
  786.   natively to Macintosh users, with no additional support required on
  787.   the Macintosh.  The two free omplementations are Netatalk,
  788.   <http://www.umich.edu/~rsug/netatalk/>, and CAP,
  789.   <http://www.cs.mu.oz.au/appletalk/atalk.html>.  What Samba offers MS
  790.   Windows users, these packages offer to Macs.  For more info on these
  791.   packages, Samba, and Linux (and other UNIX-based systems) see
  792.   <http://www.eats.com/linux_mac_win.html>
  793.   33..22..  SSeessssiioonn rreeqquueesstt ffaaiilleedd ((113311,,113300))"" eerrrroorr
  794.  
  795.  
  796.   The following answer is provided by John E. Miller:
  797.  
  798.   I'll assume that you're able to ping back and forth between the
  799.   machines by IP address and name, and that you're using some security
  800.   model where you're confident that you've got user IDs and passwords
  801.   right.  The logging options (-d3 or greater) can help a lot with that.
  802.   DNS and WINS configuration can also impact connectivity as well.
  803.  
  804.   Now, on to 'scope id's.  Somewhere in your Win95 TCP/IP network
  805.   configuration (I'm too much of an NT bigot to know where it's located
  806.   in the Win95 setup, but I'll have to learn someday since I teach for a
  807.   Microsoft Solution Provider Authorized Tech Education Center - what an
  808.   acronym...) Note: It's under Control Panel | Network | TCP/IP | WINS
  809.   Configuration there's a little text entry field called something like
  810.  
  811.   This field essentially creates 'invisible' sub-workgroups on the same
  812.   wire.  Boxes can only see other boxes whose Scope IDs are set to the
  813.   exact same value - it's sometimes used by OEMs to configure their
  814.   boxes to browse only other boxes from the same vendor and, in most
  815.   environments, this field should be left blank.  If you, in fact, have
  816.   something in this box that EXACT value (case-sensitive!) needs to be
  817.   provided to smbclient and nmbd as the -i (lowercase) parameter. So, if
  818.   your Scope ID is configured as the string 'SomeStr' in Win95 then
  819.   you'd have to use smbclient -iSomeStr otherparms in connecting to it.
  820.  
  821.  
  822.   33..33..  HHooww ddoo II ssyynncchhrroonniissee mmyy PPCC''ss cclloocckk wwiitthh mmyy SSaammbbaa sseerrvveerr??
  823.  
  824.  
  825.   To syncronize your PC's clock with your Samba server:
  826.  
  827.   +o  Copy timesync.pif to your windows directory
  828.  
  829.   +o  timesync.pif can be found at:
  830.      <http://samba.org/samba/binaries/miscellaneous/timesync.pif>
  831.  
  832.   +o  Add timesync.pif to your 'Start Up' group/folder
  833.  
  834.   +o  Open the properties dialog box for the program/icon
  835.  
  836.   +o  Make sure the 'Run Minimized' option is set in program 'Properties'
  837.  
  838.   +o  Change the command line section that reads \sambahost to reflect
  839.      the name of your server.
  840.  
  841.   +o  Close the properties dialog box by choosing 'OK'
  842.  
  843.      Each time you start your computer (or login for Win95) your PC will
  844.      synchronize its clock with your Samba server.
  845.  
  846.   Alternativley, if you clients support Domain Logons, you can setup
  847.   Domain Logons with Samba - see: BROWSING.txt
  848.   <ftp://samba.org/pub/samba/docs/BROWSING.txt> *** for more
  849.   information.
  850.  
  851.   Then add
  852.  
  853.  
  854.        NET TIME \\%L /SET /YES
  855.  
  856.  
  857.  
  858.  
  859.   as one of the lines in the logon script.
  860.  
  861.   33..44..  PPrroobblleemmss wwiitthh WWiinnDDDD,, NNTTrriigguuee,, WWiinnCCeenntteerrPPrroo eettcc
  862.  
  863.  
  864.   All of the above programs are applications that sit on an NT box and
  865.   allow multiple users to access the NT GUI applications from remote
  866.   workstations (often over X).
  867.  
  868.   What has this got to do with Samba? The problem comes when these users
  869.   use filemanager to mount shares from a Samba server. The most common
  870.   symptom is that the first user to connect get correct file permissions
  871.   and has a nice day, but subsequent connections get logged in as the
  872.   same user as the first person to login. They find that they cannot
  873.   access files in their own home directory, but that they can access
  874.   files in the first users home directory (maybe not such a nice day
  875.   after all?)
  876.  
  877.   Why does this happen? The above products all share a common heritage
  878.   (and code base I believe). They all open just a single TCP based SMB
  879.   connection to the Samba server, and requests from all users are piped
  880.   over this connection. This is unfortunate, but not fatal.
  881.  
  882.   It means that if you run your Samba server in share level security
  883.   (the default) then things will definately break as described above.
  884.   The share level SMB security model has no provision for multiple user
  885.   IDs on the one SMB connection. See security_level.txt
  886.   <ftp://samba.org/pub/samba/docs/security_level.txt> in the docs
  887.   for more info on share/user/server level security.
  888.  
  889.   If you run in user or server level security then you have a chance,
  890.   but only if you have a recent version of Samba (at least 1.9.15p6). In
  891.   older versions bugs in Samba meant you still would have had problems.
  892.  
  893.   If you have a trapdoor uid system in your OS then it will never work
  894.   properly. Samba needs to be able to switch uids on the connection and
  895.   it can't if your OS has a trapdoor uid system. You'll know this
  896.   because Samba will note it in your logs.
  897.  
  898.   Also note that you should not use the magic "homes" share name with
  899.   products like these, as otherwise all users will end up with the same
  900.   home directory. Use \serversername instead.
  901.  
  902.  
  903.   33..55..  PPrroobblleemm wwiitthh pprriinntteerrss uunnddeerr NNTT
  904.  
  905.  
  906.   This info from Stefan Hergeth hergeth@f7axp1.informatik.fh-muenchen.de
  907.   may be useful:
  908.  
  909.   A network-printer (with ethernetcard) is connected to the NT-Clients
  910.   via our UNIX-Fileserver (SAMBA-Server), like the configuration told by
  911.   Matthew Harrell harrell@leech.nrl.navy.mil (see WinNT.txt)
  912.  
  913.   1. If a user has choosen this printer as the default printer in his
  914.      NT-Session and this printer is not connected to the network (e.g.
  915.      switched off) than this user has a problem with the SAMBA-
  916.      connection of his filesystems. It's very slow.
  917.  
  918.   2. If the printer is connected to the network everything works fine.
  919.  
  920.   3. When the smbd ist started with debug level 3, you can see that the
  921.      NT spooling system try to connect to the printer many times. If the
  922.      printer ist not connected to the network this request fails and the
  923.      NT spooler is wasting a lot of time to connect to the printer
  924.      service.  This seems to be the reason for the slow network
  925.      connection.
  926.  
  927.   4. Maybe it's possible to change this behaviour by setting different
  928.      printer properties in the Print-Manager-Menu of NT, but i didn't
  929.      try it yet.
  930.  
  931.  
  932.   33..66..  WWhhyy aarree mmyy ffiillee''ss ttiimmeessttaammppss ooffff bbyy aann hhoouurr,, oorr bbyy aa ffeeww hhoouurrss??
  933.  
  934.  
  935.   This is from Paul Eggert eggert@twinsun.com.
  936.  
  937.   Most likely it's a problem with your time zone settings.
  938.  
  939.   Internally, Samba maintains time in traditional Unix format, namely,
  940.   the number of seconds since 1970-01-01 00:00:00 Universal Time (or
  941.   ``GMT''), not counting leap seconds.
  942.  
  943.   On the server side, Samba uses the Unix TZ variable to convert
  944.   internal timestamps to and from local time.  So on the server side,
  945.   there are two things to get right.
  946.  
  947.   1. The Unix system clock must have the correct Universal time.  Use
  948.      the shell command "sh -c 'TZ=UTC0 date'" to check this.
  949.  
  950.   2. The TZ environment variable must be set on the server before Samba
  951.      is invoked.  The details of this depend on the server OS, but
  952.      typically you must edit a file whose name is /etc/TIMEZONE or
  953.      /etc/default/init, or run the command `zic -l'.
  954.  
  955.   3. TZ must have the correct value.
  956.  
  957.      a. If possible, use geographical time zone settings (e.g.
  958.         TZ='America/Los_Angeles' or perhaps TZ=':US/Pacific').  These
  959.         are supported by most popular Unix OSes, are easier to get
  960.         right, and are more accurate for historical timestamps.  If your
  961.         operating system has out-of-date tables, you should be able to
  962.         update them from the public domain time zone tables at
  963.         <ftp://elsie.nci.nih.gov/pub/>.
  964.  
  965.      b. If your system does not support geographical timezone settings,
  966.         you must use a Posix-style TZ strings, e.g.
  967.         TZ='PST8PDT,M4.1.0/2,M10.5.0/2' for US Pacific time.  Posix TZ
  968.         strings can take the following form (with optional items in
  969.         brackets):
  970.  
  971.                 StdOffset[Dst[Offset],Date/Time,Date/Time]
  972.  
  973.  
  974.      where:
  975.  
  976.      +o  `Std' is the standard time designation (e.g. `PST').
  977.  
  978.      +o  `Offset' is the number of hours behind UTC (e.g. `8').  Prepend
  979.         a `-' if you are ahead of UTC, and append `:30' if you are at a
  980.         half-hour offset.  Omit all the remaining items if you do not
  981.         use daylight-saving time.
  982.  
  983.      +o  `Dst' is the daylight-saving time designation (e.g. `PDT').
  984.  
  985.         The optional second `Offset' is the number of hours that
  986.         daylight-saving time is behind UTC.  The default is 1 hour ahead
  987.         of standard time.
  988.  
  989.      +o  `Date/Time,Date/Time' specify when daylight-saving time starts
  990.         and ends.  The format for a date is `Mm.n.d', which specifies
  991.         the dth day (0 is Sunday) of the nth week of the mth month,
  992.         where week 5 means the last such day in the month.  The format
  993.         for a time is hh:mm[:ss], using a 24-hour clock.
  994.  
  995.         Other Posix string formats are allowed but you don't want to
  996.         know about them.
  997.  
  998.      On the client side, you must make sure that your client's clock and
  999.      time zone is also set appropriately.  [I don't know how to do
  1000.      this.]  Samba traditionally has had many problems dealing with time
  1001.      zones, due to the bizarre ways that Microsoft network protocols
  1002.      handle time zones.  A common symptom is for file timestamps to be
  1003.      off by an hour.  To work around the problem, try disconnecting from
  1004.      your Samba server and then reconnecting to it; or upgrade your
  1005.      Samba server to 1.9.16alpha10 or later.
  1006.  
  1007.  
  1008.   33..77..  HHooww ddoo II sseett tthhee pprriinntteerr ddrriivveerr nnaammee ccoorrrreeccttllyy??
  1009.  
  1010.  
  1011.   Question: On NT, I opened "Printer Manager" and "Connect to Printer".
  1012.   Enter "\ptdi270s1"
  1013.   in the box of printer. I got the following error message:
  1014.  
  1015.  
  1016.             You do not have sufficient access to your machine
  1017.             to connect to the selected printer, since a driver
  1018.             needs to be installed locally.
  1019.  
  1020.  
  1021.  
  1022.  
  1023.   Answer:
  1024.  
  1025.   In the more recent versions of Samba you can now set the "printer
  1026.   driver" in smb.conf. This tells the client what driver to use. For
  1027.   example:
  1028.  
  1029.  
  1030.             printer driver = HP LaserJet 4L
  1031.  
  1032.  
  1033.  
  1034.  
  1035.   with this, NT knows to use the right driver. You have to get this
  1036.   string exactly right.
  1037.  
  1038.   To find the exact string to use, you need to get to the dialog box in
  1039.   your client where you select which printer driver to install. The
  1040.   correct strings for all the different printers are shown in a listbox
  1041.   in that dialog box.
  1042.  
  1043.   You could also try setting the driver to NULL like this:
  1044.  
  1045.  
  1046.             printer driver = NULL
  1047.  
  1048.  
  1049.  
  1050.  
  1051.   this is effectively what older versions of Samba did, so if that
  1052.   worked for you then give it a go. If this does work then let us know
  1053.   via samba@samba.org, and we'll make it the default. Cur-
  1054.   rently the default is a 0 length string.
  1055.  
  1056.  
  1057.   33..88..  II''vvee aapppplliieedd NNTT 44..00 SSPP33,, aanndd nnooww II ccaann''tt aacccceessss SSaammbbaa sshhaarreess,,
  1058.   WWhhyy??
  1059.  
  1060.  
  1061.   As of SP3, Microsoft has decided that they will no longer default to
  1062.   passing clear text passwords over the network.  To enable access to
  1063.   Samba shares from NT 4.0 SP3, you must do OONNEE of two things:
  1064.  
  1065.   1. Set the Samba configuration option 'security = user' and implement
  1066.      all of the stuff detailed in ENCRYPTION.txt
  1067.      <ftp://samba.org/pub/samba/docs/ENCRYPTION.txt>.
  1068.  
  1069.   2. Follow Microsoft's directions for setting your NT box to allow
  1070.      plain text passwords. see Knowledge Base Article Q166730
  1071.      <http://www.microsoft.com/kb/articles/q166/7/30.htm>
  1072.  
  1073.  
  1074.   44..  SSppeecciiffiicc cclliieenntt aapppplliiccaattiioonn pprroobblleemmss
  1075.  
  1076.  
  1077.  
  1078.  
  1079.   44..11..  MMSS OOffffiiccee SSeettuupp rreeppoorrttss ""CCaannnnoott cchhaannggee pprrooppeerrttiieess ooff ''MMSSOOFF--
  1080.   FFIICCEEUUPP..IINNII''""
  1081.  
  1082.  
  1083.   When installing MS Office on a Samba drive for which you have admin
  1084.   user permissions, ie. admin users = username, you will find the setup
  1085.   program unable to complete the installation.
  1086.  
  1087.   To get around this problem, do the installation without admin user
  1088.   permissions The problem is that MS Office Setup checks that a file is
  1089.   rdonly by trying to open it for writing.
  1090.  
  1091.   Admin users can always open a file for writing, as they run as root.
  1092.   You just have to install as a non-admin user and then use "chown -R"
  1093.   to fix the owner.
  1094.  
  1095.  
  1096.   55..  MMiisscceellllaanneeoouuss
  1097.  
  1098.  
  1099.  
  1100.   55..11..  IIss SSaammbbaa YYeeaarr 22000000 ccoommpplliiaanntt??
  1101.  
  1102.  
  1103.   The CIFS protocol that Samba implements negotiates times in various
  1104.   formats, all of which are able to cope with dates beyond 2000.
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.